查看“Patch Mod 制作文档”的源代码

=<kbd>Next Patch Mod 制作文档</kbd>=


==<kbd>1 什么是 Patch Mod</kbd>==


Patch Mod是对需要 Next插件Mod（简称Next） 进行加载的mod的称呼，以便与需要 BepinEx 加载的Mod进行区分。（Next本身需要BepinEx进行加载）

==<kbd>2 新建 Patch Mod</kbd>==


在 <code>觅长生/本地Mod测试/</code> 文件夹下，新建文件夹。
文件夹内目录结构如下

===<kbd><font size=4px color=#e8ebdd>Mod目录结构</font></kbd>===


V2版本

<syntaxhighlight>
plugins
└── Next
   └── mod测试                 PatchMod文件夹
       ├── Assets                  Mod资源文件夹
       ├── Config                  Mod配置文件夹
       │   └── modConfig.json          Mod描述文件
       ├── Data                    游戏数据文件夹
       ├── Lua                     Lua数据文件夹
       └── NData                   Next数据文件夹
</syntaxhighlight>

Next Patch的文件夹以 mod 开头，如 <code>mod测试</code>
只有以"mod"开头的文件夹会被加载。

==<kbd>3 Mod描述文件</kbd>==


Mod描述文件是用于描述mod名称、作者、版本与介绍。

该文件本身不影响mod加载，但是完善的mod描述文件有利于留下mod作者的信息，以及进行版本管理等。

===<kbd>3.1 创建描述文件</kbd>===


新建json文件，保存至 <code>mod测试/Config/modConfig.json</code> 的路径中

文件结构：

modConfig.json

<syntaxhighlight lang="json">
{
   "Name" : "测试Mod",
   "Author" : "佚名",
   "Version" : "1.0.0",
   "Description" : "测试用的Mod。",
   "Settings" : [ ... ]
}
</syntaxhighlight>

详见[[描述文件设置|'''描述文件设置''']]

==<kbd>4 数据Patch</kbd>==


数据Patch是指对游戏原版数据进行修改与增加。（目前未提供删除功能）

===<kbd>4.1 数据类型</kbd>===


当Next安装后，可以点击Next面板上的【导出Base】，自动导出Data文件。

点击面板上的【打开导出文件夹】按钮，即可找到导出的Data文件

导出的游戏数据位于 <code>..OutPutData</code> 根据Next的安装位置，有所不同

Data文件夹里的文件，大致分为三类：

1.  普通Json数据文件<br/>
    该类文件格式如下

    <syntaxhighlight lang="json">
    {
       "1":{
           //......
       },
       "2":{
           //......
       }
    }
    </syntaxhighlight>

    对这类文件制作补丁时，只需要在 <code>Data</code> 文件夹里创建同名json文件，然后进行修改/新增数据即可。如：

    <syntaxhighlight lang="json">
    {
       "2":{
           //......
       },
       "10":{
           //......
       }
    }
    </syntaxhighlight>

    与源数据ID一致的数据会进行替换，其余的数据则会新增到原版数据末尾

2.  字典json数据文件<br/>
    该类文件是放到文件夹里的特殊json文件，其文件名构成了数据的ID，如<code>ItemJsonData/</code>文件夹内的文件：<br/>
    <code>1.json</code>

    <syntaxhighlight lang="json">
    {
       "id":1,
       "ItemIcon":0,
       "maxNum":1,
       "name":"锈渍铁剑",
       "TuJianType":0,
       "ShopType":99,
       "ItemFlag":[
           1,
           101
       ],
       "WuWeiType":0,
       "ShuXingType":0,
       "type":0,
       "quality":1,
       "typePinJie":1,
       "StuTime":0,
       "seid":[
           2
       ],
       "vagueType":0,
       "price":350,
       "desc":"主动：下一次造成的伤害提升25%（血量低于10时才能使用）",
       "desc2":"剑身满是锈渍，看起来连凡人用的武器都不如，魏无极的残魂便寄居在其中。",
       "CanSale":1,
       "DanDu":0,
       "CanUse":0,
       "NPCCanUse":0,
       "yaoZhi1":0,
       "yaoZhi2":0,
       "yaoZhi3":0,
       "wuDao":[]
    }
    </syntaxhighlight>

    要修改此类文件时，将该文件一份至mod文件夹里的<code>Data/ItemJsonData</code>文件夹，然后修改其数据即可。<br/>
    如若需要新增数据，则将数据名称命名为新的数字，并修改数据内的ID与其一致即可。

3.  SeidJson数据<br/>
    该类文件与类型1一样，但是其是放置在文件夹类的。目前版本以<code>SeidJsonData</code>结尾的文件夹皆属于该类。<br/>
    如 <code>BuffSeidJsonData/1.json</code> 文件，呈如下结构：

    <syntaxhighlight lang="json">
    {
       "1":{
           "id":1,
           "value1":1
       },
       "2":{
           "id":2,
           "value1":-1
       },
       //......
    }
    </syntaxhighlight>

    需要在该类文件里修改或新增数据时，参考类型1的文件，在mod文件夹里新建 <code>BuffSeidJsonData/1.json</code>：

    <syntaxhighlight lang="json">
    {
       "1":{
           "id":1,
           "value1":10
       },
       "666":{
           "id":666,
           "value1":1
       }
    }
    </syntaxhighlight>

    与源数据ID一致的数据会进行替换，其余的数据则会新增到原版数据末尾<br/>
    注：该类文件一般为游戏内功能函数的配置文件，例如buff数据里配置的seid会在buffSeid文件夹里寻找对应的json文件，然后在该文件内寻找该buffID对应的数据。

===<kbd>4.2 增量修改</kbd>===


Next 0.3.0 版本新增了增量修改的功能

当对源数据进行修改时，可以填写需要修改的部分。这样其他内容则不会被覆盖

如 <code>ItemJsonData/1.json</code>

<syntaxhighlight lang="json">
{
   "id":1,
   "ItemIcon":0,
   "maxNum":1,
   "name":"锈渍铁剑",
   "TuJianType":0,
   "ShopType":99,
   "ItemFlag":[
       1,
       101
   ],
   "WuWeiType":0,
   "ShuXingType":0,
   "type":0,
   "quality":1,
   "typePinJie":1,
   "StuTime":0,
   "seid":[
       2
   ],
   "vagueType":0,
   "price":350,
   "desc":"主动：下一次造成的伤害提升25%（血量低于10时才能使用）",
   "desc2":"剑身满是锈渍，看起来连凡人用的武器都不如，魏无极的残魂便寄居在其中。",
   "CanSale":1,
   "DanDu":0,
   "CanUse":0,
   "NPCCanUse":0,
   "yaoZhi1":0,
   "yaoZhi2":0,
   "yaoZhi3":0,
   "wuDao":[]
}
</syntaxhighlight>

制作增量补丁时，可以写成如下格式：

<syntaxhighlight lang="json">
{
   "name":"魏老之剑",
   "desc2":"这就是传说中的修仙老爷爷，魏无极的残魂便寄居在其中。",
}
</syntaxhighlight>

这样游戏里的最终数据便会变为如下：

<syntaxhighlight lang="json">
{
   "id":1,
   "ItemIcon":0,
   "maxNum":1,
   "name":"魏老之剑",
   "TuJianType":0,
   "ShopType":99,
   "ItemFlag":[
       1,
       101
   ],
   "WuWeiType":0,
   "ShuXingType":0,
   "type":0,
   "quality":1,
   "typePinJie":1,
   "StuTime":0,
   "seid":[
       2
   ],
   "vagueType":0,
   "price":350,
   "desc":"主动：下一次造成的伤害提升25%（血量低于10时才能使用）",
   "desc2":"这就是传说中的修仙老爷爷，魏无极的残魂便寄居在其中。",
   "CanSale":1,
   "DanDu":0,
   "CanUse":0,
   "NPCCanUse":0,
   "yaoZhi1":0,
   "yaoZhi2":0,
   "yaoZhi3":0,
   "wuDao":[]
}
</syntaxhighlight>

增量修改可以避免游戏本体更新而导致需要重新适配数据文件，并且多个Mod之间也可以相互以增量修改的形式相互覆盖。

===<kbd>4.3 数据含义参考</kbd>===


此处可参考官方的Excel开源文件

或参考3DM一位大佬的[https://bbs.3dmgame.com/thread-6185512-1-1.html 此篇帖子]

==<kbd>5 剧情文件</kbd>==


===<kbd>5.1 介绍</kbd>===


剧情文件是Next添加的剧情配置文件，用于向游戏内添加剧情。由于该功能由Next提供运行框架与扩展方法，因此能实现的功能较为有限。有更多的需求欢迎提Issue。

===<kbd>5.2 创建剧情文件</kbd>===


在Mod文件夹里新建 <code>NData/DialogEvent</code> 文件夹，随后在该文件夹里新建任意名称的json文件，文件结构如下：

<code>example.json</code>

<syntaxhighlight lang="json">
[
   {
       "id":"测试1",
       "character":{
           "旁白" : 0,
           "主角" : 1,
           "倪旭欣" : 609
       },
       "dialog":[
           "主角#武当如何？",
           "倪旭欣#武当天下第一！",
           "旁白#你怎么看？"
       ],
       "option":[
           "天下第一！#测试2",
           "天下第一鸭！"
       ]
   },
   {
       "id":"测试2",
       "character":{
           "主角" : 1
       },
       "dialog":[
           "主角#确实。"
       ],
       "option":[

       ]
   }
]
</syntaxhighlight>

对象解释：

{|id="CardSelectTr" class="CardSelect wikitable" style="width: 100%;color: #e8ebdd;border: 2px solid #878787;box-shadow: 0px 0px 3px 2px rgb(0 0 0 / 30%);font-size: 13px;"
|-
!字段
!类型
!说明
|-
|id
|字符串
|唯一ID
|-
|character
|字典<br/>字符串-数字 键值对
|储存预定义的角色ID<br/>预定义ID只能用于重要NPC的对话头像显示<br/>特殊ID：<br/>旁白：0<br/>主角：1<br/>更多的预定义ID可以在文件<code>AvatarJsonData.json</code>里查询
|-
|dialog
|字符串列表
|对话指令列表，详见 [[剧情对话指令|'''剧情对话指令''']]
|-
|option
|字符串列表
|选项指令列表，详见 [[选项指令|'''选项指令''']]
|}<br>

==<kbd>6 触发器文件</kbd>==


===<kbd>6.1 介绍</kbd>===


触发器文件是Next添加的触发器配置文件，用于为剧情提供触发方式。由于触发器由Next提供对游戏原本功能的接口检测，因此能实现的功能较为有限。有更多的需求欢迎提Issue。

===<kbd>6.2 触发器文件</kbd>===


在Mod文件夹里新建 <code>NData/DialogTrigger</code> 文件夹，随后在该文件夹里新建任意名称的json文件，文件结构如下：

<code>example.json</code>

<syntaxhighlight lang="json">
[
   {
       "id":"测试触发器",
       "type":"交谈",
       "condition":"roleBindID==609",
       "triggerEvent":"测试1",
       // 默认true
       "default" : true,
       // 默认false
       "once" : false
   }
]
</syntaxhighlight>

对象解释：

{|id="CardSelectTr" class="CardSelect wikitable" style="width: 100%;color: #e8ebdd;border: 2px solid #878787;box-shadow: 0px 0px 3px 2px rgb(0 0 0 / 30%);font-size: 13px;"
|-
!字段
!类型
!说明
|-
|id
|字符串
|唯一ID
|-
|type
|字符串
|触发器类型，参考[[触发器类型|'''触发器类型''']]
|-
|condition
|字符串
|检测指令，参考[[运行时脚本|'''运行时脚本''']]
|-
|triggerEvent
|字符串
|触发事件，使用事件ID<br>参考本篇 **5 剧情文件**
|-
|default
|布尔类型
|初始状态，false为关闭，true为开启，关闭的触发器不会参与触发判断
|-
|once
|布尔类型
|是否触发后自动关闭，默认false
|}<br>

==<kbd>7 添加资源</kbd>==


Next为游戏引入了添加自定义资源的功能

===<kbd>7.1 介绍</kbd>===


在Mod文件夹里新建 <code>Assets</code> 文件夹，将图标按指定的目录放入其中，即可在游戏内读取出来

===<kbd>7.2 详情</kbd>===


该部分可参考 [[添加资源|'''添加资源''']]

==<kbd>8 自定义捏脸数据</kbd>==


===<kbd>8.1 介绍</kbd>===


从Next 0.3.5版本开始，添加了自定义捏脸数据的功能。
通过自定义捏脸数据，可以替换或指定重要NPC的捏脸立绘。
也可以用于<code>SetCustomFace</code>指令更改角色的立绘。

注：定义的立绘文件需要新开档生效，或使用<code>SetCustomFace</code>指令强制刷新立绘，如<code>SetCustomFace*614#614</code>可强制刷新林沐心的立绘。

===<kbd>8.2 捏脸数据文件</kbd>===


在Mod文件夹里新建 <code>NData/CustomFace</code> 文件夹，随后在该文件夹里新建任意名称的json文件，文件结构如下：

<syntaxhighlight lang="json">
{
   "ID": 618,
   "RandomInfos": {
     "head": 99,
     "eyes": 99,
     "mouth": 99,
     "nose": 99,
     "eyebrow": 99,
     "hair": 99,
     "feature": 99,
     "yanying": 99,
     "a_suit": 95,
     "hairColorR": 99,
     "yanzhuColor": 99,
     "tezhengColor": 99,
     "eyebrowColor": 99
   }
}
</syntaxhighlight>

ID 为捏脸数据的ID
RandomInfos 为捏脸数据具体内容

与Seid文件不同之处在于，该处json文件仅使用文件内定义的ID作为导入的捏脸立绘ID。

通过使用

*   调试面板 - NPC调试 - 选择NPC - 导出捏脸数据  可将捏脸数据复制到剪切板

或者

*   调试面板 - 杂项调试 - 导出主角捏脸  可将捏脸数据导出到输入框内，自行将其复制出来即可。

导出主角立绘 功能可在角色创建界面进行捏脸后导出。

==<kbd>9 Lua脚本</kbd>==


===<kbd>9.1 介绍</kbd>===


Lua脚本不同于运行时脚本，运行时脚本本质上仅是为了方便进行逻辑运算而引入的C#逻辑判断脚本，但Lua脚本则可以独立调用剧情指令，进行更加复杂的流程调控。

===<kbd>9.2 详情</kbd>===


该部分可参考 [[Lua脚本|'''Lua脚本''']]

==<kbd>10 Fungus补丁</kbd>==


===<kbd>10.1 介绍</kbd>===


====<kbd>Fungus是什么</kbd>====


Fungus是觅长生原生的剧情运行框架，游戏内的原版剧情由Fungus运行。

====<kbd>Fungus补丁是什么</kbd>====


从Next 0.5.0版本开始，Next提供了修改Fungus的方法，通过创建Fungus补丁，可以对原版剧情进行新增与删除，方便与原版剧情交互。

===<kbd>10.2 创建Fungus补丁</kbd>===


该部分可参考 [[Fungus补丁|'''Fungus补丁''']]

{{左侧目录|结束}}


{{Next导航}}

{{#Widget:Next-wiki-css}}